home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / apps / 710 / spoflt26 / spoflt21.doc < prev    next >
Text File  |  1993-05-25  |  12KB  |  261 lines
  1.  
  2. S P E E D   O F   L I G H T
  3.  
  4. Version 2.1   Released March 12, 1993.
  5. High speed GIF (87a) viewer.
  6.  
  7. All coding and design by Stuart Denman.
  8.  
  9. Email: stusoft@u.washington.edu
  10.  
  11.  
  12. THIS PROGRAM IS SHAREWARE!!!
  13.  
  14. Version 2.1 runs (and is fully tested) on all standard ST/STE/MEGA/TT
  15. computers, and even the new FALCON030!  It supports the Falcon's new
  16. resolutions as well as its extended palette.  Speed of Light is able
  17. to increase this to 16 million, however! =)  I have added several new
  18. features, and a lot of bug-fixes to version 2.1, including making it
  19. now run on older STs without 2 bombs (sorry about that), so please
  20. read the changes at the end of this manual.  This program MIGHT not
  21. work with graphics cards or other non-standard video screens because
  22. of the fast customized routines.
  23.  
  24. If you use this program regularly, please send $20 (U.S. funds if possible) to:
  25.  
  26. STUART DENMAN
  27. 1751 N.E. NAOMI PLACE
  28. SEATTLE, WA 98115   USA
  29.  
  30. (Please see the enclosed README!.1ST file for information on address changes).
  31.  
  32. Don't forget a return address!!
  33.  
  34. When a later version comes out that will allow high speed dithering,
  35. the ability to display and save various formats, and the ability to
  36. enlarge as well as reduce (to name a few), I will send all registered
  37. users a KEY CODE so you can access these new features in version 3.0.
  38. If this isn't enough incentive to support the program, I also need the
  39. money!  This way I can continue to produce quality programs such as
  40. this with the latest software development tools.
  41.  
  42.  
  43. WHAT'S THE DIFFERENCE BETWEEN SPEED OF LIGHT AND OTHER VIEWERS?
  44.  
  45. Speed of Light is not only the fastest GIF uncompressor know to the
  46. Atari world, but it also displays more than the normal 16 colors in
  47. any 16 color resolution on an ST/STE/TT, including TT Medium!  It
  48. supports 256 color modes as well and uses a flickering method (which
  49. is hardly noticable) to increase the palette to tens of thousands of
  50. colors on the STE/TT.  On regular ST's, you get the extended palette
  51. of an STE/TT and more.  On the FALCON, 16 million+ is also possible.
  52.  
  53.     This would not look very good if it wasn't for a sophisticated
  54. algorithm which compares all the colors and comes up with the
  55. combination that looks the best.  This uses a technique I call color
  56. vector distancing, which I will not get into here.  Normal GIF viewers
  57. produce renderings of the original that lack interresing
  58. colors...there's no contrast between them.  With color distancing,
  59. Speed of Light chooses the colors that are a set distance appart
  60. (chosen at the options screen) and displays only them (from the most
  61. popular color in the picture on down).  This distance value or Color
  62. Contrast ranges from 0 to 255.  The best values depend on the number
  63. of colors and shades that your computer can display.  The default
  64. values are ones which I've found produces a good picture with most
  65. GIFs, but experimentation does help to get the best rendering for a
  66. particular GIF.  The main program was written in GFA Basic, but
  67. whenever a lot of speed was required, I wrote those routines in pure
  68. Assembly Language.
  69.  
  70.  
  71. RUNNING THE PROGRAM
  72.  
  73. Double click or drag a GIF file to SPOFLT21.PRG.  If you drag a
  74. picture to SPOFLT21.PRG, make sure that it is either installed as an
  75. application with "Full path" and "Default directory=Application"
  76. highlighted.  Either that or highlight these options on the "Desktop
  77. Configuration" screen on later TOS versions.  If you do not do this,
  78. the program will not be able to find the GIF file, or SPOFLT21.RSC.
  79.     A box should pop up giving the credits and shareware information.
  80. Click or press any key to continue.  If you did not drag a GIF file to
  81. SPOFLT21.PRG to run it, the program will display a fileselect box for
  82. you to select the GIF file to display.  Next it will load and
  83. uncompress the picture.
  84.     If the picture is too large for the available memory, you may get
  85. a dialog box allowing you to specify what part of the picture to load
  86. in.  You have the option to either cut out certain lines (reduce), or
  87. load in only a section of the picture.  To reduce it, select the
  88. amount of reduction on both axes of the picture and click on REDUCE.
  89. If this is not enough reduction to fit the whole picture into memory,
  90. the program will warn you with an alert box.  If you want to view just
  91. a section of the picture, move the slider with the percentage of the
  92. picture that will fit into memory on it.  This determines what section
  93. (along the Y-axis) that you want to see.  Then click on SECTION.  If
  94. you want to load a New File or Quit instead, click on those buttons.
  95.  
  96.  
  97. THE OPTIONS SCREEN
  98.  
  99. The options screen will appear with the name of the GIF file as well
  100. as its dimentions and color/palette numbers.  The first decision is
  101. whether you want to display the picture in color or in greyscale.
  102. It must, of course, be a color picture for anything to look right
  103. with the color display option.  Greyscale GIFs may look better with
  104. the greyscale option than with the color option.  Click on COLOR or
  105. GREYSCALE to select how it will be displayed.
  106.     The two slider bars next to these buttons determine the offset
  107. from the normal red/green/blue values that the final picture will
  108. have.  For greyscale, this allows you to make bluescale, greenscale,
  109. or whatever.  For color, you can add or subtract red/green/blue to the
  110. original picture colors.  You can brighten or darken the picture in
  111. either display mode by adjusting the red/green/blue sliders by the
  112. same amount.  These sliders will NOT be reset to zero each time you
  113. load a new GIF, only when you first run the program.  You can easily
  114. reset these values to zero by clicking on the red arrow in the center
  115. above these sliders.
  116.     The color functions only affect color displays.  The COLOR
  117. CONTRAST slider effects the distancing between the colors as descibed
  118. in a previous paragraph.  The FLICKER CONTRAST limits the colors that
  119. the program chooses to flicker with.  This sets the maximum contrast
  120. between two colors that are flickered.  Flicker Contrast ranges from 0
  121. to 255, 0 being no flickering at all, and 255 being high flickering.
  122. Speed of Light only flickers the colors if it finds that it may
  123. improve the picture.
  124.     The two buttons under these sliders determine the method the
  125. program uses to reduce the colors.  This makes no difference if the
  126. number of colors in the GIF is the same as can be displayed on screen
  127. at one time.  The FREQUENCY method chooses the colors that are the
  128. most frequent in the picture, and then distances them as determined
  129. with the Color Contrast slider.  One could notice that if you use this
  130. method and set Color and Frequency Contrast to their lowest values,
  131. the picture will look exactly like those of other GIF viewers.  It is
  132. Color Contrasting that makes the difference in Speed of Light.
  133. PALETTE reduction method is similar to Frequency method, but is a lot
  134. slower and usually produces WORSE results.  It chooses its colors by
  135. comparing them within the palette itself, and not by which is the most
  136. frequent in the picture.
  137.     The next section allows you to set the size of the picture that
  138. will be displayed.  The sliders determine the amount of reduction
  139. along the X and Y axes of the picture.  A value of 1 will not cut the
  140. picture at all.  2 will display every second line, 3 every third line,
  141. and so on.  This allows you to fit a huge picture on a small screen
  142. like ST Low resolution.
  143.     AVERAGING can be used if the reduction is 2 or greater on either
  144. axis.  This can be slow (especially with color), but it produces the
  145. most accurate results when reducing a picture.  It will smooth out
  146. jagged edges (otherwise know as stair-steps) and takes into account
  147. the lines that are skipped when averaging is off.
  148.  
  149.  
  150. DISPLAYING THE PICTURE
  151.  
  152. Click on QUIT to exit the program or NEW FILE to select a new GIF to
  153. display.  To show the current picture, click on DISPLAY.
  154.     After it calculates the colors (if in color mode) the picture
  155. will be displayed.  Flickering will not happen until it is done
  156. drawing the picture unless "Flickerdraw" mode is on (described below).
  157.  
  158. While the picture is being displayed, the following commands can be
  159. entered with the keyboard:
  160.  
  161. M           Toggle "flickerdraw" mode on and off.  "flickerdraw" means
  162.             that the picture will flicker even while it draw the lines
  163.             of the picture onto the screen.   This way, you will
  164.             always see the expanded palette.  This mode can be slow
  165.             when scrolling around (especially along the horizontal
  166.             axis).  Flickerdraw mode does not work when the picture
  167.             is being averaged.
  168.  
  169. SPACE       Toggles between flickering the picture and not flickering
  170.             it.  If the program is drawing the picture, it will stop
  171.             drawing and flicker what it has already drawn until you
  172.             press SPACE again or enter another command.
  173.  
  174. UP-ARROW    Moves the picture up if it is larger than the screen.
  175.  
  176. DOWN-ARROW  Moves the picture down if it is larger than the screen.
  177.  
  178. RIGHT-ARROW Moves the picture right if it is larger than the screen.
  179.  
  180. LEFT-ARROW  Moves the picture left if it is larger than the screen.
  181.  
  182. CONTROL +   Moves the picture in the specified direction one quarter
  183.     ARROWS  of the screen.
  184.  
  185. R or ESC    Returns to options screen.
  186.  
  187. F           Selects a new picture file.
  188.  
  189. Q           Quits the program.
  190.  
  191.  
  192. (See README.1ST file for changes to these KEYBOARD commands in version 2.6).
  193.  
  194.  
  195. The MOUSE can also be used to return to the options screen by
  196. pressing the RIGHT MOUSE BUTTON.  You may need to hold it down if the
  197. program is drawing the picture in averaging mode and it takes a long
  198. time to display each line.  After it has drawn the picture, you can
  199. move the mouse RIGHT/LEFT/UP/DOWN to scroll the picture as with the
  200. arrow keys, above.  It is hard to explain how this works, you have to
  201. get used to it yourself.  The farther you move the mouse the more the
  202. screen jumps as it moves in that direction.  You must center the
  203. mouse to get it to stop scrolling.  You can either move the mouse to
  204. the center (although the pointer is not visible) or you can press the
  205. LEFT MOUSE BUTTON to automatically center the mouse.
  206.  
  207.  
  208. ADDITIONS IN VERSION 2.1
  209. (Most of these new feature are documented above.  This is NOT the
  210. same manual that came with version 2.0, so read it again if you
  211. havn't already.)
  212.  
  213. --  The program now works on STs and Falcon030s.  Supporting the
  214.     Falcon's new graphics modes.
  215.  
  216. --  A tremendous increase in drawing speed was implimented.
  217.  
  218. --  Averaging is now more accurate.
  219.  
  220. --  Averaging now draws correctly in 256 color modes.
  221.  
  222. --  A "backward" memory error cause out of memory alerts, even when
  223.     plenty of memory was available.
  224.  
  225. --  A dialog box was added to allow big pictures to be loaded into
  226.     systems with limited memory.
  227.  
  228. --  A red arrow was added to the options screen to allow automatic
  229.     centering of the RED/GREEN/BLUE sliders.
  230.  
  231. --  Flickerdraw mode was added.
  232.  
  233. --  Automatic centering of the mouse by LEFT-clicking was added to
  234.     the mouse scrolling feature.
  235.  
  236. --  Other various bugs were fixed.
  237.  
  238. --  A Speed of Light icon is included for desktops that support
  239.     custom icons.
  240.  
  241. SHAREWARE PLEA!!!!
  242.  
  243. Please support shareware authors as they work very hard to bring you
  244. inexpensive but professional programs.  The more support authors get
  245. the more incentive we have to release our work into the public domain.
  246.  
  247. Again, if you use this program, send $20 to:
  248.  
  249. STUART DENMAN
  250. 1751 N.E. NAOMI PLACE
  251. SEATTLE, WA 98115   USA
  252.  
  253. (You're essentially buying access to version 3.0).
  254.  
  255. Questions/comments can be sent via Email to:
  256.  
  257. stusoft@u.washington.edu
  258.  
  259.  
  260. ENJOY SPEED OF LIGHT!!!
  261.